home *** CD-ROM | disk | FTP | other *** search
/ Microsoft Multimedia Viewer How-To CD / Microsoft Multimedia Viewer How-To CD.iso / viewerht / addons / tstools / readme.txt < prev    next >
Text File  |  1994-03-02  |  9KB  |  143 lines
  1. TouchSend Readme.Txt:
  2.  
  3. Note:
  4. =============
  5. Make sure you don't run the tstools.mvb demo and the tstoolsw.dll in a project at the same time.  It will not work and you will get an error message saying one or the other of the dll's are damaged.  They are not, but do not work together at the same time.
  6.  
  7. Last minute note:
  8.  
  9. We have also found that running in 1024x768 or 800x600 with large fonts caused the menu buttons on the opening screen to be pushed out of view.  Please change to normal font or 640x480.
  10.  
  11. We have also noted that if two buttons are created that autosize to text and one has lower case and one has upper and lower case, they will not be the same height.  The fix (it will be fixed in the next build of the DLL) for TsToolsW.DLL is to ensure that all buttons are the same case mix or to author specify the width and height.
  12. Also TsTools.mvb and TsToolsW.mvb cannot be running simultaneously - as they conflict in memory.
  13.  
  14. =================================================================
  15.  
  16. The TouchSend Tools directory on this CD Rom consists of the following:
  17.  
  18. tstools.mvb    This demo of TouchSend Tools
  19.  
  20. tstools.dll    The DLL to run the demo (it will only run with the demo)
  21.  
  22. tshelp.hlp     A help file used in the demo
  23.  
  24. tshelp1.hlp    A help file used in the demo
  25.  
  26. tstoolsw.mvb   The help and how to Viewer Title for the tstoolsw.dll
  27.  
  28. tstoolsw.dll   The TouchSend Tools working sampler DLL provided.
  29.  
  30. readme.txt     This file.
  31.  
  32. rr.txt         The function declarations to be inserted in the configuration section of the MVP file for the TsToolsW.DLL functions.  
  33.  
  34. Note:  Because these declarations are so "fussy" ie  "i" is not the same as "I" and "u" is not the same as "U", **** IT IS RECOMMENDED THAT THE ENTIRE FILE BE PASTED INTO THE CONFIG SECTION EVEN IF YOU AREN'T USING SOME OF THE FUNCTIONS****  This will save hours of frustration trying to figure out why something doesn't work.
  35.  
  36. The tstoolsw.dll enclosed is a full working version of the following functions:
  37.  
  38. TsToolsInit
  39. ===========
  40. must be the first function called in the configuration script of the MVP file ***or none of the other functions will work***.  TsToolsInit initializes the TsToolsW.DLL and creates an ini file in the Windows directory that is used by TsToolsW.DLL.  The author controls the name of the ini file.  It is **strongly** recommended that each title have a different ini name.
  41.  
  42. TsAbsolute
  43. ==========
  44. Viewer device-independent measurements map position values into a 1,024-by-1,024 grid. At run time, these measurements are converted to device-specific coordinates using a scaling ratio appropriate to the display device.  For example, in 640-by-480 video mode, a device-independent measurement of 512 (specified for the X or Width parameters) would be converted to a pixel measurement of 320 (512 x (640/1024)). For the Y and Height parameters, the same value would produce a pixel measurement of 240 (512 x (480/1024) ).  TsAbsolute(0) will cause TsButtons to be mapped to a device independent 1024x1024 grid.  TsAbsolute(1) [the default if not called] will ensure that whatever pixel coordinates are specified will be reproduced on the screen.
  45.  
  46. TsCopyString
  47. ============
  48. copies a specified string to the clipboard.
  49.  
  50. TsHelpContext
  51. =============
  52. calls context sensitive help from Viewer.
  53.  
  54. TsInfoBox
  55. ==========
  56. creates a 3 line "about" or dialog box.  The author has control over the text in the title bar, 3 lines of text in the dialog box and the color of the dialog box.
  57.  
  58. TsSaveBaggage
  59. =============
  60. copies a specified file from baggage to a file on the hard disk.  Storing files in baggage is extremely useful and this function provides a way to retrieve stored files.  By making careful use of this command together with marks, an author can extract a file that is appropriate for the current user.  As an example, if the author wants to illustrate a point using a spreadsheet file, the function can extract a Lotus, Excel or Quattro Pro file dependent on the user's selected spreadsheet preference and the others never clutter the users disk or create conversion/confusion problems.
  61.  
  62. TsWrite
  63. =======
  64. calls Write.exe and using the other Write functions, allows the author to manipulate write from Viewer.
  65.  
  66. TsWriteCopy
  67. ===========
  68. calls Write.exe and allows the user copie highlighted material to the clipboard.
  69.  
  70. TsWriteKill
  71. ===========
  72. will close Write after opened with TsWrite.
  73.  
  74. TsWritePaste
  75. ============
  76. will paste the contents of the clipboard into Write.
  77.  
  78. TsWritePos
  79. ==========
  80. will set the screen position of Write after it has been opened using TsWrite.
  81.  
  82. TsWriteSetZ
  83. ===========
  84. will set the screen "z order" of Write after opened with TsWrite.
  85.  
  86. TsYN
  87. ====
  88. creates an about box with yes and no buttons.  It has all of the same capabilities as TsInfoBox but as well will submit a command to Viewer based on the button pressed.
  89.  
  90. The TsWrite function set is a Write.exe specific group of functions that emulates the TsExec functions (which do the same thing for virtually any Windows application) but limited to work just with Write.
  91.  
  92. THE TSWRITE FUNCTIONS ILLUSTRATE ONE OF THE CHALLENGES OF HYPETEXT MULTIMEDIA DELIVERY SYSTEMS, NAMELY: ONCE AN AUTHOR HANDS DATA TO A USER: HE OR SHE WANTS TO BE ABLE TO DO SOMETHING WITH IT.  THESE TOOLS AND THE TSEXEC  FUNCTIONS ARE DESIGNED TO FULFILL THOSE NEEDS.
  93.  
  94. Windows allows an author to manage and use multiple applications to manage and manipulate information.  This will become more apparent and even easier with the release of Windows 4.0 (now code named "Chicago" by Microsoft).
  95.  
  96. The TsToolsW.DLL also includes a subset of the functions available in the commercial version of the TsButton embedded pane.
  97.  
  98. TsButton allows the author to create buttons in embedded panes in Viewer.  This tool provides the author with ultimate flexibility in creating exciting titles with a custom look and feel.  
  99.  
  100. The following TsButton capabilites are provided in TSTOOLSW.DLL:
  101.  
  102. -autosizing to text
  103. -use of any font available on the users system at any allowable pixel size
  104. -control over height and width
  105. -control over border and depth
  106. -control of italics, underline, bold and overstrike text display
  107. -control over text alignment and margins
  108. -notching
  109. -angled text
  110. -xy start location of text
  111. -attaching Viewer command strings to any button
  112.  
  113. The following functions available in the commercial version of TsButton are not included in TSTOOLSW.DLL:
  114.  
  115. -the ability to disable the button
  116. -3 dimensional looking fonts
  117. -the ability to inhibit printing of the button
  118. -the ability to hide/restore the button
  119. -multiline  text buttons
  120. -the ability to place graphics on the button
  121. -the ability to click the button by function call.
  122. -mouse enter and mouse leave events.
  123.  
  124. A full description of TsTools can be found by selecting the TsToolsW Online section of this title, and then selecting "TsTools Commercial Version".  All of the functions (at press time) are fully described.  We did not repeat any of the information relating to TsButtons which are clearly documented under the heading "TsButtons"
  125.  
  126. Note:  If you don't have time to click through the entire demo, please make sure you select the "don't miss" button on the button bar in the TsToolsW Online section.
  127.  
  128. Special note regarding TsButtons
  129.  
  130. Viewer creates embedded panes by looking for {ewx....} as a structure in a rich text format file (where the x is either an "l","c" or an "r").  If there is an extra curly bracket in the line, usually Viewer will crash.  Don't despair.  Also because of the myriad of authoring control provided with TsButton, it is easy to make a mistake in the switch syntax.  TouchSend has put extensive error checking in to deal with those issues, but occasionally Viewer will crash if your syntax is wrong, or alternatvely the button won't draw as you have intended.  Check your button syntax carefully (not always as easy to do as to say !!).
  131.  
  132. The commercial version of TsTools has an authoring tool to create buttons and manage the syntax.
  133.  
  134.  
  135.  
  136. If you have any questions we will be happy to answer them, but only via Compuserve 73374,2071.
  137.  
  138. Orders for the commercial version of TsTools can be placed via Compuserve or via phone 904-668-6180 or by fax at 904-668-5352.  Payment must be by cheque in advance of delivery to TouchSend Tools c/o 1904 Chatsworth Way Tallahassee, Florida 32308.  The TsTools set offer through this book also contains the source files for this demo (not the bitmaps or avi's though) which exhaustively show the techniques used to create this demo.  Make sure you mention that you want the Waite Group version to ensure that the source code is sent. 
  139.  
  140. Pricing for TouchSend tools is $279 per development machine, and $279 for each commercial title.  Commercial titles that are updated require a further payment but not more than once per year.  Except for the title fee, there are no runtime charges and no royalties.   There are no additional charges for inhouse use or for noncommerical titles.  There are no additional charges for networks or wide area networks.  Please include $7.95 for shipping and handling for each order.  Florida residents add 7% sales tax.
  141.  
  142. TouchSend« is a registered trademark of TouchSend Corporation used under licence by TouchSend Management Consulting Inc.  TouchSend Tools are provided in a dynamic link library and will run under Windows 3.1 or greater.
  143.